home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / tutor / dosguide.exe / HELPDOS.ZIP / BACKUP.HLP < prev    next >
Text File  |  1985-09-10  |  4KB  |  94 lines
  1. -----------------------  BACKUP - External DOS Command  ------------------------
  2.  
  3. BACKUP makes backup copies of one or more files from a fixed disk to diskettes.
  4.     The backup files are stored in a special DOS BACKUP format and can be
  5.     retrieved only with the RESTORE command.
  6.  
  7. FORMAT:   BACKUP [d1:][path][filename[.ext]] d2:[/S][/M][/A][/D:mm-dd-yy]
  8.  
  9. REMARKS:
  10.  
  11.    d1       - the drive letter of the fixed disk.  If omitted, the default drive
  12.               is assumed.
  13.    path     - the directory path of the directory whose files are to be backed
  14.               up.  If omitted, the current directory is assumed.
  15.    filename - the filename of the files to be backed up.  Global characters
  16.               (* and ?) are allowed.
  17.    .ext     - the filename extension of the files to be backed up.  Global
  18.               characters (* and ?) are allowed.
  19.    d2       - the drive letter of the diskette drive which will receive the back
  20.               ups.
  21.    /S       - causes files in all subdirectories of the specified directory
  22.               (specified in "path"), in addition to the specified directory, to
  23.               be backed up.  This includes all levels of subdirectories beyond
  24.               the specified directory.
  25.    /M       - specifies that only those files that have been modified or created
  26.               since the last backup are to be backed up.
  27.    /A       - specifies that backed up files are to be added to the files
  28.               already on the diskette in the backup drive.  You will not be
  29.               prompted to insert a diskette in the backup drive when this
  30.               parameter is specified.
  31.    /D:mm-dd-yy - specifies that only files created or modified on or after the
  32.               date given in mm-dd-yy are to be backed up.
  33.  
  34.    If you do not use the /A parameter, DOS will prompt you to insert a backup
  35.    diskette.  All files already on the disk will be erased before the back up
  36.    occurs.  When a diskette is full, you will be prompted to insert the next
  37.    backup diskette.  You should record the backup diskette number and the date
  38.    of backup on the external label of the diskette.
  39.  
  40.    You must use DOS formatted diskettes only.
  41.  
  42.    BACKUP displays each file's name as it is backed up.  You can use
  43.    "redirection" to direct the display to the printer or to a file (see examples
  44.    below).
  45.  
  46.    Backup files created with BACKUP are usable only by the RESTORE command.  Use
  47.    RESTORE to restore a file that was backed up with the BACKUP command.
  48.  
  49.    When BACKUP completes, it sets an exit code.  These exit codes can be tested
  50.    in an IF Batch Subcommand in a batch file.  The ERRORLEVEL variable will be
  51.    set to one of the following the exit codes:
  52.  
  53.       0 = Normal Completion
  54.       1 = No files to be backed up were found
  55.       3 = Backup terminated by user (with Ctrl-Break)
  56.       4 = Backup terminated due to error
  57.  
  58.  
  59. WARNING:  All files on the diskettes to receive the backups are erased before
  60.    the backup occurs (unless the /A parameter is specified).
  61.  
  62.  
  63. EXAMPLES:
  64.  
  65. Back up all files on fixed disk drive C to diskette drive A:
  66.  
  67.           BACKUP C:\ A:/S
  68.  
  69.  
  70. Back up all files on fixed disk drive C that have been created or modified since
  71. the last backup to diskette in drive A:
  72.  
  73.           BACKUP C:\ A:/S/M
  74.  
  75.  
  76. Back up all files on fixed disk drive C that have been created or modified since
  77. the last backup to diskette in drive A.  The files are to be added to the files
  78. already on the drive A diskette:
  79.  
  80.           BACKUP C:\ A:/S/M/A
  81.  
  82.  
  83. Back up all files on fixed disk drive C that have been created or modified since
  84. April 5, 1985 to diskette in drive A:
  85.  
  86.           BACKUP C:\ A:/S/D:04-05-85
  87.  
  88.  
  89. Back up all files in the directory BUDGET of drive C that have a filename
  90. extension of .DAT. The BUDGET directory is a subdirectory of the root level.
  91. The files are to be backed up to diskette in drive A:
  92.  
  93.           BACKUP C:\BUDGET\*.DAT A:
  94.